home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / util / cli / SED.readme < prev    next >
Encoding:
Text File  |  2000-11-02  |  6.4 KB  |  167 lines
  1. Short:    Amiga stream editor
  2. Author:   thor@math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  4. Version:  40.2
  5. Type:     util/cli
  6. Requires: AmigaOs 3.0 or better
  7.  
  8. ______________________________________________________________________________
  9.  
  10. Purpose of this program:
  11.  
  12.     SED takes an input file, checks each line of this file against a
  13.     pattern supplied on the command line, and generates a new line from
  14.     this pattern match in the destination. This could either mean that
  15.     the matching line is removed completely from the output, replaced
  16.     by a different line, or changed according to the specifications of
  17.     SED.
  18.     
  19.     SED is an approximation of the Unix "stream editor" sed. It is not
  20.     quite as powerful as sed because its command set is currently very
  21.     limited, and it does not support command files. Its pattern syntax
  22.     is different, too. It still looks like "line noise" to me - I didn't
  23.     want to break with this tradition - but it's at least the Amiga kind
  24.     of line noise.
  25.  
  26.     Its pattern matching rules are a superset of the AmigaOs patterns,
  27.     with some additional features like "captured expressions" and more
  28.     powerful "character classes" and "escaping".
  29.  
  30.     SED is useful for automatic processing of text files, e.g. the modi-
  31.     fication of the startup-sequence. SED can also be run as a "filter"
  32.     in which case it reads its input from stdin and prints output to
  33.     stdout. Combine this feature with pipes and you get a very powerful
  34.     text processing tool.
  35.  
  36.     A warning: Pattern matching looks simple, but is full of hard to gasp
  37.     traps. This tool is therefore thought to be for "expert usage". In 
  38.     case you think SED doesn't process your pattern correctly, think
  39.     twice!
  40.  
  41.     For further details, please read the SED.doc.
  42. ______________________________________________________________________________
  43.  
  44. Release 40.2:
  45.  
  46.     Due to an oversight, the character ranges [..-..] were broken.
  47.     Fixed.
  48.     Handling of (..|..) "or-operator" was broken. Fixed.
  49.     Escaping with \ could leave bogus patterns in the pattern stream
  50.     and could have caused non-justified "invalid template" errors.
  51.     Fixed.
  52.  
  53. ______________________________________________________________________________
  54.  
  55. Release 40.1:
  56.  
  57.     The former release used memory pools, but did not check correctly
  58.     whether the corresponding exec functions are available. Required
  59.     and requires Kickstart 3.0.
  60.     Could have forgotten to return "ERROR_NO_FREE_STORE" for some
  61.     out of memory error conditions.
  62.  
  63. ______________________________________________________________________________
  64.  
  65. Release 40.0:
  66.  
  67.     This is the first Aminet release. This is a 40.0 release because
  68.     pattern matching is a very complex buisiness and even though I tested
  69.     this release quite good, I wouldn't be astonished if some flaws still
  70.     remained. Pattern matching logic is astonishing sometimes, so please
  71.     check the documentation first before reporting any "obvious" bugs. The
  72.     obvious bugs should be gone already!
  73.  
  74. ______________________________________________________________________________
  75.  
  76.                          The THOR-Software Licence (v2, 24th June 1998)
  77.  
  78.  
  79. This License applies to the computer programs known as "SED". The "Program", 
  80. below, refers to such program. The "Archive" refers to the package of 
  81. distribution, as prepared by the author of the Program, Thomas Richter. 
  82. Each licensee is addressed as "you".
  83.  
  84.  
  85.  
  86. The Program and the data in the archive are freely distributable
  87. under the restrictions stated below, but are also Copyright (c)
  88. Thomas Richter.
  89.  
  90. Distribution of the Program, the Archive and the data in the Archive by a
  91. commercial organization without written permission from the author to any
  92. third party is prohibited if any payment is made in connection with such
  93. distribution, whether directly (as in payment for a copy of the Program) or
  94. indirectly (as in payment for some service related to the Program, or
  95. payment for some product or service that includes a copy of the Program
  96. "without charge"; these are only examples, and not an exhaustive enumeration
  97. of prohibited activities).
  98.  
  99.  
  100. However, the following methods of distribution
  101. involving payment shall not in and of themselves be a violation of this
  102. restriction:
  103.  
  104.  
  105. (i) Posting the Program on a public access information storage and
  106. retrieval service for which a fee is received for retrieving information
  107. (such as an on-line service), provided that the fee is not
  108. content-dependent (i.e., the fee would be the same for retrieving the same
  109. volume of information consisting of random data).
  110.  
  111.  
  112. (ii) Distributing the Program on a CD-ROM, provided that
  113.  
  114. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  115. especially this licence agreement;
  116.  
  117. b) the CD-ROM is made available to the public for a nominal fee only,
  118.  
  119. c) a copy of the CD is made available to the author for free except for
  120. shipment costs, and
  121.  
  122. d) provided further that all information on such CD-ROM is redistributable
  123. for non-commercial purposes without charge.
  124.  
  125.  
  126. Redistribution of a modified version of the Archive, the Program or the
  127. contents of the Archive is prohibited in any way, by any organization,
  128. regardless whether commercial or non-commercial. Everything must be kept
  129. together, in original and unmodified form.
  130.  
  131.  
  132.  
  133.  
  134. Limitations.
  135.  
  136.  
  137. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  138. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  139. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  140. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  141. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  142. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  143. SERVICING, REPAIR OR CORRECTION.
  144.  
  145.  
  146. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  147. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  148. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  149.  
  150.  
  151.                                                         Thomas Richter
  152. ______________________________________________________________________________
  153.  
  154. Thomas Richter,
  155.                 Oktober 2000
  156.  
  157.  
  158. ============================= Archive contents =============================
  159.  
  160. Original  Packed Ratio    Date     Time    Name
  161. -------- ------- ----- --------- --------  -------------
  162.     6444    4134 35.8% 15-Oct-00 00:37:28 +SED
  163.    18443    6731 63.5% 15-Oct-00 17:30:44 +SED.doc
  164.     6096    2742 55.0% 15-Oct-00 00:16:54 +SED.readme
  165. -------- ------- ----- --------- --------
  166.    30983   13607 56.0% 17-Oct-100 21:19:54   3 files
  167.